home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / pira151a.zip / CONDR203.ZIP / CONDOR.DOC next >
Text File  |  1987-05-01  |  37KB  |  1,072 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                  CONDOR.EXE - 15.1A Doorware Link for PCBoard
  20.  
  21.              Ver 2.01 (C) Copyright 1987 Intermountain Softworks
  22.  
  23.                   Please study documentation for proper use
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                  May 1, 1987
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.     Intermountain Softworks is pleased to add a short but useful software
  37.     product to the worldwide PC-standard inventory.   Although CONDOR.EXE
  38.     will only interest PCBoard system operators running enhanced versions
  39.     11.8D/E  under license,  we are hopeful that BBS'ers everywhere  will
  40.     find more reasons to enjoy their local systems,  and support them  to
  41.     the fullest.
  42.  
  43.     CONDOR will thoroughly convince 15.1A  releases of RBBS-PC "doorware"
  44.     they're  running  under    RBBS.   For  suggested  sources  of  these
  45.     applications,    refer  to  our  resource list at  the  end  of  this
  46.     document.
  47.  
  48.     Users  are   cordially  invited to visit our own  PCBoard  system  at
  49.     509/529-7229.   Our maximum bit rate is 2400.  We operate 24 hours on
  50.     weekends,     and  between  1600h  and  0600h  weekdays,     Pacific.
  51.     Weekdays, the system is subject to availability after midnight.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.     CONDOR.EXE - Installation and Use
  59.  
  60.     
  61.  
  62.  
  63.  
  64.     1.0 - Acknowledgements                                               2
  65.     1.1 - Limited License                                                3
  66.     1.2 - Shareware Distribution                                         3
  67.     1.3 - What's New With Condor Two                                     4
  68.     1.4 - Version-Specific Requirements                                  5
  69.     1.5 - What's Needed                                                  5
  70.     1.6 - Overview                                                       6
  71.     1.7 - Multi-Node Environment                                         7
  72.  
  73.     2.0 - Getting Started                                                7
  74.     2.1 - Batch Files                                                    9
  75.     2.2 - Subdirectories                                                11
  76.     2.3 - Disk Buffers                                                  12
  77.     2.4 - Error Messages                                                12
  78.  
  79.     3.0 - Resources                                                     13
  80.     3.1 - A Note for Door Developers                                    13
  81.  
  82.     Appendix A - Error Messages                                         14
  83.     Appendix B - CONDOR Problem Report Form                             16
  84.     Appendix C - CONDOR Registration Request Form                       18
  85.  
  86.  
  87.  
  88.  
  89.     1.0 - Acknowledgements
  90.  
  91.     PCBoard (C) 1985..1987 Clark Development Company, Inc. (Murray, UT)
  92.  
  93.     RBBS-PC (C) 1983..1987 D. Thomas Mack (Great Falls, VA)
  94.  
  95.     Microsoft,   MS,  and MS-DOS are registered trademarks  of  Microsoft
  96.     Corporation.
  97.  
  98.     Within  the  context  of  this  document,   MS-DOS  and  PC-DOS   are
  99.     equivalent.
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.                                     Page 2                                    
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.     CONDOR.EXE - Installation and Use
  119.  
  120.     
  121.     1.1 - Limited License
  122.  
  123.          The CONDOR package,  consisting of CONDOR.EXE and this document,
  124.     CONDOR.DOC,   is the exclusive property of  Intermountain  Softworks,
  125.     P. O. Box 2043, Walla Walla, WA  99362.  The package may also include
  126.     certain non-copyrighted sample data and/or batch files.
  127.  
  128.          Users  are  granted  a  limited  license  to  copy  and   freely
  129.     distribute copies of the CONDOR package,  so long as the  distributed
  130.     copies  are  unmodified,  the copyright notice  is  neither  changed,
  131.     removed,   or  bypassed,   and  that  an  unmodified  copy  of   this
  132.     documentation  accompany  the  package.    The  preferred  method  of
  133.     distribution  is  via one's bulletin board system.   Except  for  the
  134.     actual  cost of disk media,  mailer,  and postage,  or the normal BBS
  135.     subscription fee, if any, such distribution must be without charge.
  136.  
  137.          Although  Intermountain Softworks is satisfied that this product
  138.     will perform as represented,  and that due care has been exercised in
  139.     development, CONDOR is offered on an "as-is" basis, without warranty,
  140.     either  expressed  or implied.   By use of this product,    the  user
  141.     assumes  all  risk,    to  include  responsibility  for  installation
  142.     consistant  with  examples  included  in  this   document,    and  as
  143.     promulgated  by  the developers of PCBoard.
  144.  
  145.          The  libraries  we  use  under license are  fully  protected  by
  146.     federal law, as is CONDOR.
  147.  
  148.     1.2 - Shareware Distribution
  149.  
  150.          It  should be obvious that none of us is getting rich  from  BBS
  151.     support applications and doors.  CONDOR represents, by this time, far
  152.     more  hours of work than we imagined.   The "work"  is attempting  to
  153.     decipher  what certain applications are doing,  and what they expect,
  154.     rather   than  writing brilliant code.   If you  wish   to  undertake
  155.     this yourself (in lieu of our modest $10   fee),  blessings and peace
  156.     be upon you!  Let us point out, however,  that the present version is
  157.     complex  enough  to preclude any justification  in  disassembly,   or
  158.     "reverse  engineering,"   particularly when formats  are  subject  to
  159.     change within a matter of months.
  160.  
  161.          If you use CONDOR,  you are EXPECTED to register your copy.  Our
  162.     thanks  to  the  handful  of SysOps who have done  so.    Whether  we
  163.     continue this project as shareware,  or continue it at all,   depends
  164.     largely upon the monitary return on our investment in time.   Profit,
  165.     obviously, is hardly a motive at $10.
  166.  
  167.          The  version-specific  nature of CONDOR dictates a  short  shelf
  168.     life.  You also may need help,  and we normally ignore operator pages
  169.     from non-registered users.
  170.  
  171.                                     Page 3                                    
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.     CONDOR.EXE - Installation and Use
  179.  
  180.  
  181.          Registered users will receive one year's complementary access to
  182.     our PCBoard  system for thirty-five minutes per day,   and access  to
  183.     all  operating   "doors."      Registration also  entitles   one   to
  184.     technical  support   within  the scope of CONDOR,   via  our  PCBoard
  185.     system.     A registration form is included for your convenience.
  186.  
  187.     1.3 - What's New With Condor Two
  188.  
  189.          Automatic generation of support files.   Other than RBBSxPC.DEF,
  190.     which  must  be edited with CONFIG.EXE (ver 30.1   or  later),    all
  191.     doorware support files are generated by CONDOR as necessary.
  192.  
  193.          Local mode doorware access from PCBoard.  SysOps may now exit to
  194.     any  15.1A doorware application from PCBoard,  like any remote  user.
  195.     Even RBBS-PC SysOps can't do this with doorware!
  196.  
  197.          Trap errorlevel within calling batch file.  If CONDOR aborts for
  198.     any reason  (abnormal termination),  an errorlevel of 3 is passed  to
  199.     MS-DOS.   This  value may be trapped within the calling  batch  file,
  200.     which  then reinvokes BOARD.BAT for return to PCBoard.
  201.  
  202.          Network or DoubleDOS (tm)   support  under  MS-DOS file sharing.
  203.     Provided  one's multi-node operation recognizes MS-DOS  file  sharing
  204.     standards,  CONDOR  will  now handle up to three nodes.    Additional
  205.     support is available,   up to the present doorware limit of nine,  on
  206.     special order.
  207.  
  208.          9600 bps now supported, removing previous limit of 2400.
  209.  
  210.          Diagnostic error messages.
  211.  
  212.          The increase in CONDOR's size is no cause for concern.   Indeed,
  213.     unless  you have an accurate stopwatch,  the difference in  execution
  214.     speed is negligible.   Even with all of the diagnostic code in place,
  215.     we noticed little difference between CONDOR 1.51  and Beta A of 2.00.
  216.     The  copy you have removes that,  of course.   Most of CONDOR's brief
  217.     appearance is spent waiting on disk I/O,  rather than massaging data.
  218.     Data is transferred in "blocks," and further processed within memory,
  219.     keeping disk access to a minimum.
  220.  
  221.          When you see the message, "Updating [drive/pathname] messages,"
  222.     CONDOR is finished.  The subsequent lag is loading and initializing
  223.     230K of Tradewars or whatever.
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.                                     Page 4                                    
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.     CONDOR.EXE - Installation and Use
  239.  
  240.  
  241.     1.4 - Version-Specific Requirements
  242.  
  243.          CONDOR  2.0   is designed to operate with PCBoard 11.8D/E,   and
  244.     probably   forthcoming  version  11.9D/E.    This  compatibility   is
  245.     determined  by  the  format of PCBOARD.SYS,  and the  method  PCBoard
  246.     presently uses to exit through doors.
  247.  
  248.          Doorware is an entirely different matter.   Many of the routines
  249.     within  CONDOR  are hard-coded to specific bytes within  the  RBBS-PC
  250.     15.1A  definition  file(s),   the messages file,   and  the  doorware
  251.     applications,  or more precisely,  the manner in which 15.1A doorware
  252.     interprets these files.  If any of these character positions changes,
  253.     even the number of commas within the  .DEF files, you'll need another
  254.     version of CONDOR.   Unless,  of course,  doorware runs under PCBoard
  255.     without any help from us.
  256.  
  257.          CONDOR  2.0,  therefore,  does not support versions of  doorware
  258.     prior to 15.1A.
  259.  
  260.     1.5 - What's Needed
  261.  
  262.          In  addition  to  the CONDOR package,  now in  your  possession,
  263.     you'll need  the  RBBS-PC 15.1A configuration  utility,   CONFIG.EXE.
  264.     This utility  is analogous to PCBSETUP.EXE.   It also must be version
  265.     30.1   or  later;   earlier versions won't work.   The  file  may  be
  266.     downloaded  from  us  as  CNFG301.ARC,  without validation  or  other
  267.     formality,   or from any of the RBBS-PC systems cited in our resource
  268.     list.
  269.  
  270.          Users   should   carefully   review   CDC's   instructions   for
  271.     implementation of doors, contained within PCBOARD.DOC.  The following
  272.     sections build on that knowledge.  Additionally, if you are operating
  273.     a  multi-node  environment  for  PCBoard,  and  plan  to  make  doors
  274.     available  to  each node,  you'll want to study CDC's  discussion  of
  275.     network  operation  with their product.   We have made no attempt  to
  276.     supplant  this  material,   or  your need  to  fully  understand  the
  277.     requirements of network or multi-tasking software used.
  278.  
  279.          While  not  absolutely necessary,  we suggest that you  consider
  280.     running  doorware  applications  under  MONITOR  15.1A,   since  this
  281.     arrangement  is  clearly the intent of doorware's authors.    MONITOR
  282.     controls  elapsed  time  (once  invoked,   without  referencing  time
  283.     variables from the main program),  and manages "door points"  for the
  284.     individual applications.
  285.  
  286.          MONI151A.ARC  may  be downloaded from us,  from  Bob  Westcott's
  287.     board,  or from Loren Jones'  board.   The others may have it by this
  288.     time.  Our usual 24-hour validation applies for downloading.
  289.  
  290.  
  291.                                     Page 5                                    
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.     CONDOR.EXE - Installation and Use
  299.  
  300.          Additional   documentation.    Other  than  briefly  noting  the
  301.     essential options within CONFIG.EXE,  we have not made any attempt to
  302.     document its  operation,  nor have we treated RBBS-PC file formats or
  303.     network matters.   We  invite  your attention to Tom Mack's extensive
  304.     and  thorough documentation for RBBS-PC 15.1A,  as well as the source
  305.     code  for  it.    MS-QuickBASIC programmers should  have  this  as  a
  306.     standard reference.    Tom will appreciate that we borrowed his  file
  307.     formats (impossible to avoid,  because doorware uses them),  but that
  308.     the "language is different."
  309.  
  310.     1.6 - Overview
  311.  
  312.          Our program "Condor"  is not a trademark,  and we hope that  the
  313.     only entity who has a vested interest in the name is a certain  bird.
  314.     Needless  to  say,  we didn't ask the bird for permission to use  his
  315.     name.   Condor is a convenient six-character filename (to allow space
  316.     for the revision level).   It is sort of an acronym for CONvert DoOR.
  317.     It  doesn't  convert anything,  but merely translates PCBoard's  exit
  318.     file PCBOARD.SYS into a format that version 15.1A doorware expects.
  319.  
  320.          Condor  was  originally  written  as a quick  fix  for  our  own
  321.     problems in running "Tradewars"  with PCBoard.  At the time,  we were
  322.     not aware that doorware author Bob Westcott was making an attempt  to
  323.     support   PCBoard   SysOps  with  an  MS-QuickBASIC   effort   called
  324.     DOORCONV.EXE.  We  merely needed a small,  fast utility that would do
  325.     the necessary translation in a flash,  and get out of the way.   And,
  326.     it  needed  enough  flexibility  to  adapt to virtually  any  PCBoard
  327.     subdirectory configuration.
  328.  
  329.          The   concept   of  a "door to MS-DOS"    within  BBS   software
  330.     probably originated  with  Tom Mack and Jon Martin as part  of  their
  331.     RBBS-PC development.     Tom writes of "horizontal growth"   and adds
  332.     that   the term "doors"   was coined to eliminate any confusion  with
  333.     MS-Windows.  Doors  are  not even remotely like "Windows";    indeed,
  334.     a    door   is little  more than an exit from the BBS to  a  separate
  335.     application,  on the tenuous thread of an MS-DOS batch file.
  336.  
  337.          We  suspect  that  Microsoft never intended batch  files  to  be
  338.     invoked remotely by BBS patrons.   The vehicle, however,  is provided
  339.     with  MS-DOS,     and  with careful planning and  judicious  use   of
  340.     support utilities, batch files are secure enough.
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.                                     Page 6                                    
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.     CONDOR.EXE - Installation and Use
  359.  
  360.  
  361.          A "conversion" utility like Condor shouldn't be necessary.   Any
  362.     programmer who spends all the time  and trouble  to write a door  for
  363.     either  PCBoard or RBBS-PC may  address both  audiences  with  little
  364.     additional effort.   Ideally,  a  door configuration screen would ask
  365.     under  which  system  a user proposes  to operate.   Unless the  door
  366.     author  has some  political  reason  for limiting  his product to one
  367.     system  or  the other,    the larger  market potential  in   building
  368.     flexible doors makes infinitely  more  sense.   After all,  shareware
  369.     dollars are not that easy to find!
  370.  
  371.     1.7 - Multi-Node Environment
  372.  
  373.          CONDOR  2.0   attempts to stay out of network  or  multi-tasking
  374.     matters as much as possible.  If you are successfully running PCBoard
  375.     under a true network,  or under DoubleDOS,  CONDOR shouldn't give you
  376.     any trouble.
  377.  
  378.          CONDOR's  main  functions  are to ensure that  files  supporting
  379.     doorware are where they're supposed to be,  and to manage node record
  380.     updates within the RBBS-PC messages file.
  381.  
  382.          CONDOR has control of this file only for an instant,  and during
  383.     that  time,  locks the entire file.   After updating the  appropriate
  384.     node record with currently-logged user data, the lock is removed, and
  385.     the  file  is closed.   CONDOR places no other  restrictions  on  the
  386.     messages file.
  387.  
  388.          Since  doorware  only needs to read the appropriate node  record
  389.     once during initialization,  we are confident that doorware follows a
  390.     similar procedure,  or at least relinquishes all further claim to the
  391.     messages file once the data has been read.  If this turns out to be a
  392.     false  assumption,  CONDOR will complain with an error message,   and
  393.     abort after a default number of tries on the hijacked file.
  394.  
  395.          If  your  network  or  multi-tasking  software  requires  unique
  396.     filenames for all files, merely append the node number to CONDOR, and
  397.     reference it that way within the invoking batch file.
  398.  
  399.     2.0 - Getting Started
  400.  
  401.          The  first  step  is  to have CONFIG.EXE generate  one  or  more
  402.     RBBSxPC.DEF files.   If you are running a single node,  you should be
  403.     able  to use the .DEF file you already have,  provided it was created
  404.     with version 30.1 (or later) of the configuration utility.
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.                                     Page 7                                    
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.     CONDOR.EXE - Installation and Use
  419.  
  420.  
  421.          If  you  are running a true network,  or using  DoubleDOS,   you
  422.     should start from scratch with the .DEF files.
  423.  
  424.          Upon  initialization,   CONFIG will ask,  "Will you  be  running
  425.     multiple  copies of RBBS-PC (Yes or No)?"   Obviously,  if running  a
  426.     single node, answer "no."  A "yes"  answer will prompt "To which copy
  427.     of RBBS-PC will these options apply (1 to 36)?"
  428.  
  429.          For  a multi-node setup,  you'll need to rerun config  for  EACH
  430.     node,   generating a separate and distinct RBBS1PC.DEF,  RBBS2PC.DEF,
  431.     etc.,  for EACH node.   The .DEF file is unique to each node,  and is
  432.     NOT shared.
  433.  
  434.     Options which concern you are as follows:
  435.  
  436.     1  - SysOps first name
  437.     2  - SysOps last name
  438.     10 - Are you using ANSI.SYS with a color monitor
  439.     16 - Name of RBBS-PC shown initially is (19 characters)
  440.     103- File RBBS builds dynamically to open a door
  441.     141- Maximum number of concurrent RBBS-PC's
  442.     201- Communications port to be used by RBBS-PC
  443.  
  444.          Option  10   is  analogous to "seeing what the  user  sees"   on
  445.     PCBoard's  local monitor.   Since the ANSI driver is already  loaded,
  446.     this option merely enables graphics locally within doorware.
  447.  
  448.          Option 103 may be any legal filename,  or may remain the default
  449.     of RCTTY.BAT.  CONDOR strips the drive specifier from this field, and
  450.     substitutes  the fully qualified pathname you've supplied as a target
  451.     filespec (where the messages file is written).
  452.  
  453.          Option  141   is exceedingly important,  since CONDOR uses  this
  454.     value  to  expand  the  messages file to the proper  number  of  node
  455.     records.    It also references this value in writing currently-logged
  456.     user data to the appropriate node record.   If you are running two or
  457.     three nodes, option 141 MUST reflect this.
  458.  
  459.          Option 201 tells doorware applications which COM port to use for
  460.     the node in question.
  461.  
  462.          Messages  files  created by CONFIG.EXE may  be  deleted,   since
  463.     CONDOR creates its own, automatically.  CONFIG's output will then be:
  464.  
  465.          Single node                       Multi node
  466.          -----------                       ----------
  467.          RBBS-PC.DEF                       RBBS1PC.DEF
  468.                                            RBBS2PC.DEF
  469.                                            etc.
  470.  
  471.                                     Page 8                                    
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.     CONDOR.EXE - Installation and Use
  479.  
  480.  
  481.  
  482.     2.1 - Batch Files
  483.  
  484.          A  typical  batch  file  to invoke  CONDOR  and  the  individual
  485.     doorware application should look like this:
  486.  
  487.          echo off
  488.          cls
  489.          c:\pcb\condor pcboard.sys c:\pcb\doors\messages /1
  490.          if errorlevel 3 goto exit
  491.          cd\
  492.          cd\pcb\doors
  493.          monitor 1
  494.          :exit
  495.          cd\pcb
  496.          c:\pcb\board.bat
  497.  
  498.     CONDOR's  command  line  arguments are few  and  important;   indeed,
  499.     "condor"   entered  alone  at  the MS-DOS  prompt  will  display  the
  500.     copyright box,  advise that the argument count is invalid, and abort.
  501.     In normal operation, of course, a  calling batch file will supply the
  502.     required arguments, as suggested above.
  503.  
  504.     When operating a single node, the trailing /1 is not necessary, since
  505.     CONDOR defaults to one node, if no argument is provided.
  506.  
  507.     Multi-node  operation REQUIRES the argument,  and should reflect  the
  508.     node  number  this copy of CONDOR is serving - either 1,  2,   or  3.
  509.     Mundane  details  of where to write what are handled by the  program,
  510.     based entirely upon your command line arguments.
  511.  
  512.     Note  also  that  the doorware application is called  with  a  single
  513.     argument.   This is the node number, and MUST be supplied as a "1" if
  514.     running a single node.
  515.  
  516.     With PCBoard, when running multiple nodes, it is necessary to provide
  517.     a separate copy  of  the invoking  batch  file  to each node.     The
  518.     following  example  would  properly  reside in node  2's default  (or
  519.     system) directory...
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.                                     Page 9                                    
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.     CONDOR.EXE - Installation and Use
  539.  
  540.     
  541.  
  542.     echo off
  543.     cls
  544.     c:\pcb\node2\condor pcboard.sys c:\pcb\doors\messages /2
  545.     if errorlevel 3 goto exit
  546.     cd\
  547.     cd\pcb\doors
  548.     monitor 2
  549.     :exit
  550.     cd\pcb\node2
  551.     c:\pcb\board2.bat
  552.  
  553.     Observe  our preferred use of fully-qualified  pathnames.   Some ill-
  554.     behaved  applications  have  been known to  confuse  MS-DOS,    which
  555.     normally  remembers  a  batch  file's  subdirectory  and  last   line
  556.     executed.     Calls to WATCHDOG may be safely removed, since no  user
  557.     intervention  is   allowed   within   the  batch  loop,     and 15.1A
  558.     doorware  properly  monitors  the communications port  for  loss   of
  559.     carrier.
  560.  
  561.     WARNING:   CDC's proprietary PCBTRAP.COM should be installed  without
  562.     fail  for  trapping attempted user breakouts,  as well  as  fail-safe
  563.     recovery from system errors that otherwise may abort to MS-DOS.
  564.  
  565.     Recall  from  CDC's discussion of C:\PCB\MAIN\DOORS.DAT,   that  this
  566.     security  file  requires the ACTUAL filename of  the  door's  primary
  567.     batch  file.    If  your door's controlling  batch  file  were  named
  568.     BBSLIST.BAT, then that is the name that must appear within DOORS.DAT.
  569.     Most of us prefer to shorten the name to a single word, like MONITOR.
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                    Page 10                                    
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.     CONDOR.EXE - Installation and Use
  599.  
  600.  
  601.     2.2 - Subdirectories
  602.  
  603.          Assuming CDC's standard model for running one or more main board
  604.     doors (conference doors are also possible),  where subdirectories are
  605.     arranged as shown below, we'll walk you through  installation  of the
  606.     doorware application, MONITOR.
  607.  
  608.                             Drive C:\  (Root)
  609.                               |
  610.        (Subdirectories)       |
  611.       +-----+------+------+---+--------------+
  612.       |     |      |      |                  |
  613.     Lotus   WP   dBase   etc            C:\PCB (Default)
  614.      Sub   Sub    Sub                        |
  615.                                          BOARD.BAT    (or BOARDn.BAT)
  616.                                          PCBOARD.EXE
  617.                                          PCBOARD.DAT
  618.                                          PCBOARD.SYS
  619.                                          REMOTE.SYS
  620.     Note: PCBTRAP.COM is normally        EVENT.SYS
  621.     installed via AUTOEXEC.BAT      ->   PCBTRAP.COM
  622.                                          WATCHDG1.COM
  623.                                     ->   CONDOR.EXE
  624.                                     ->   MONITOR      (.BAT file)
  625.                                              |
  626.     (All below would be C:\PCB\+name)        |
  627.        +-------+------------+--------+-----------+------------+-------+
  628.        |       |            |        |           |            |       |
  629.        UP     MAIN         GEN      HELP       DOORS         DL1     DL2
  630.        |       |            |        |           |                |
  631.      Files    MSGS         BLT      HLPA        MONITOR.EXE      Files
  632.     Uploaded  FSEC         BLTG     thru        MONITOR.*        for
  633.       to      PWRD         BLTxx    HLPZ    [*] MESSAGES         Down
  634.      Main     TCAN etc...  DIR      etc...      RBBS-PC.DEF      Load
  635.      Board    DOORS.DAT    DIRG etc...      [*] RCTTY.BAT
  636.                            DOORS
  637.                            DOORSG
  638.  
  639.     [*] Automatic creation by CONDOR.EXE
  640.  
  641.     In  particular,  note that C:\PCB\DOORS is the default directory  for
  642.     all of the support files associated with doorware.   The subdirectory
  643.     name may  be anything,  of course,  but less confusion may surface if
  644.     you stick with our examples.  CONDOR itself should reside in the same
  645.     directory  to  which PCBoard writes  PCBOARD.SYS  (normally  C:\PCB);
  646.     again, to avoid confusion.  We'll call C:\PCB the "system" directory.
  647.  
  648.     Multi-node  operators will establish a separate system directory  for
  649.     EACH node,   consistant with network or multi-tasking requirements of
  650.  
  651.                                    Page 11                                    
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.     CONDOR.EXE - Installation and Use
  659.  
  660.     PCBoard.  Like PCBOARD.SYS,  CONDOR.EXE is unique to EACH node, and a
  661.     copy of CONDOR.EXE must reside in that node's system directory.
  662.  
  663.  
  664.     2.3 - Disk Buffers
  665.  
  666.          In  the  case of a CONFIG.SYS file which tells MS-DOS  to  trust
  667.     one's judgment in a few matters,  rather than reverting to  defaults,
  668.     most of us  have safely specified FILES to equal some number,   asked
  669.     that MS-DOS install a RAMdisk, and have loaded the ANSI driver.
  670.  
  671.          Common  sense may suggest that the operating system simply reads
  672.     information  from  a disk and passes it directly to  an  application.
  673.     This is not the case.  An interim holding area, called a disk buffer,
  674.     gets it first.   A disk buffer is a 512-byte block of memory that MS-
  675.     DOS  uses   to temporarily hold information it is reading from,    or
  676.     writing to, a disk.
  677.  
  678.          If  the buffered data will be used repeatedly,  access time will
  679.     be   improved   significantly if MS-DOS does not have to reread   the
  680.     same   data   each  time  it  is  needed.     Users  are  given   the
  681.     responsibility  of  telling MS-DOS how many 512-byte disk buffers  to
  682.     allocate.  This is done within CONFIG.SYS, and uses the syntax...
  683.  
  684.               BUFFERS = nn
  685.  
  686.     where nn is an integer between 1 and 99.   Each buffer requested will
  687.     increase the resident size of MS-DOS by 528 bytes.
  688.  
  689.          Some simple algorithm could doubtless be written to suggest  the
  690.     optimum number of buffers for a particular configuration.   For a 20-
  691.     megabyte  hard disk,  with the number of subdirectories that  PCBoard
  692.     requires,  the magic number,  we believe, is between 15 and 25.   The
  693.     ultimate authority may be a stopwatch.  15 will astound you if you've
  694.     accepted  the  MS-DOS default of 2;   indeed,   PCBoard  subdirectory
  695.     searches will appear almost instantaneous.
  696.  
  697.     Multi-node  users should carefully examine network  or  multi-tasking
  698.     documentation for restrictions on the use of buffers.
  699.  
  700.     2.4 - Error Messages
  701.  
  702.          CONDOR 2.0 error messages are weighted toward the diagnostic, to
  703.     include  line  numbers when appropriate.   These will mean little  to
  704.     you,   but  will provide us with an "audit trail"  of what  may  have
  705.     happened, and where in the code it occurred.   The error messages are
  706.     more  fully discussed in Appendix A,  to include suggestions on  what
  707.     you might do to correct the error.
  708.  
  709.          If you can't resolve the problem yourself, fill out the software
  710.  
  711.                                    Page 12                                    
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.     CONDOR.EXE - Installation and Use
  719.  
  720.     problem  report,   and  either  mail  it to  us,   or  upload  it  as
  721.     SOFTPROB.xxx,   where "xxx"  is the first three letters of your  last
  722.     name.    Use a "/"  as the first character when PCBoard prompts for a
  723.     file description.   Sorry for the formality,  but the report form  is
  724.     designed   to  provide  us  with  essential  information  about  your
  725.     particular configuration, and (we hope),  provide a CLEAR explanation
  726.     of what you observed.
  727.  
  728.          Please allow us the courtesy of 24  hours for a response via our
  729.     PCBoard system.   If we charged $50  or $60  for CONDOR on an advance
  730.     basis,  we'd install an 800 number for such things.  Registered users
  731.     get special treatment, of course.
  732.  
  733.     3.0 - Resources
  734.  
  735.          The four major sources of RBBS-PC doorware are...
  736.  
  737.     415-689-2090 CA Concord
  738.     Jon Martin        4       Home of RBBS-PC West
  739.  
  740.     701-293-5973 ND Fargo
  741.     Loren Jones       4       Fargo PCUG,RBBS Beta
  742.  
  743.     603-424-5497 NH Merrimack
  744.     Bob Westcott      4       On-Line adventure,Ham
  745.  
  746.     703-759-5049 VA Great Falls
  747.     703-759-9659 VA Great Falls
  748.     Tom Mack          4       Home of RBBS-PC
  749.  
  750.  
  751.     3.1 - A Note for Door Developers
  752.  
  753.          The  following PCBoard system maintains a private conference  on
  754.     the  subject  of  doors.   A   restricted-distribution  door  kit  is
  755.     available to PCBoard licensees.
  756.  
  757.     201-729-7410 NJ Lake Mohawk
  758.     Paul Kopit      B    4       Software Soc'ty,140M
  759.  
  760.          Also,   we  attempt to stay abreast of essential  utilities  and
  761.     tools  for  door  applications programmers.   Feel free to  call  our
  762.     system during the hours indicated.
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.                                    Page 13                                    
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.     CONDOR.EXE - Installation and Use
  779.  
  780.     
  781.     Appendix A - Error Messages
  782.  
  783.          CONDOR 2.0  error messages have three general formats.  The most
  784.     common is a single static line,  followed by the usual message for an
  785.     abort:
  786.  
  787.               Invalid argument count
  788.               Abnormal program termination
  789.  
  790.     In some cases, the error message will report where CONDOR expected to
  791.     find a certain file, and didn't:
  792.  
  793.               Can't open file [drive/path] filename
  794.               Abnormal program termination
  795.  
  796.     The rarest will include a line number:
  797.  
  798.               Line nnn: lseek to node record failed
  799.               Abnormal program termination
  800.  
  801.     If  any of the "Line nnn"  messages involves "Permission denied"   or
  802.     "Resource deadlock would occur," there is little you can do except to
  803.     try the procedure again, in local mode.
  804.  
  805.     Here are the error conditions that you CAN do something about:
  806.  
  807.     Can't open file
  808.  
  809.     CONDOR  relies  upon you to supply fully qualified pathnames  through
  810.     command  line arguments within the invoking batch file.   Your second
  811.     argument  (the target,  or output,  filespec)  is the most  critical.
  812.     c:\pcb\doors\messages  also  tells CONDOR to look for RBBSxPC.DEF  in
  813.     the same location,  and to write the config option 103  file in  that
  814.     location.  "Can't open" most often means "can't find."
  815.  
  816.     DOS 3.00 or later version required
  817.  
  818.     Rare, because you wouldn't be running PCBoard with anything else.
  819.  
  820.     Invalid argument count
  821.  
  822.     Too many or too few command line arguments.   See supplied batch file
  823.     for an example of the proper format.
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.                                    Page 14                                    
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.     CONDOR.EXE - Installation and Use
  839.  
  840.  
  841.     Invalid node number
  842.  
  843.     If  the node number is supplied,  it must be in the range of 1 to  3.
  844.     Any  other number generates this error.   If no number is provided in
  845.     the command line, 1 is assumed.   Don't forget the forward slash as a
  846.     delimiter.
  847.  
  848.     Line nnn: lseek to node record failed
  849.  
  850.     RBBS-PC messages file is corrupted.   Delete this file and let CONDOR
  851.     regenerate it from scratch - automatic if file missing.
  852.  
  853.     Line nnn: Permission denied
  854.  
  855.     Sharing  violation.   Usually indicates incompatibility or a hijacked
  856.     file.
  857.  
  858.     Line nnn: Resource deadlock would occur
  859.  
  860.     Locking violation,  after ten unsuccessful attempts.  A  sure sign of
  861.     trouble.
  862.  
  863.  
  864.          CONDOR doesn't trap for everything.  For example, if you were to
  865.     rename a bogus file to PCBOARD.SYS,  CONDOR won't check the file  for
  866.     integrity,   since under normal operation,  the file would have  been
  867.     created only a moment before by the main program.  We have yet to see
  868.     this  file corrupted.    Another reason for using CONFIG to edit  the
  869.     RBBSxPC.DEF files, rather than a text editor!
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.                                    Page 15                                    
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.     CONDOR.EXE - Installation and Use
  899.  
  900.     
  901.     Appendix B - CONDOR Problem Report Form
  902.  
  903.     Instructions:   For fastest service,  please complete this form  with
  904.     your  favorite  text  editor,   and upload to our PCBoard  system  as
  905.     SOFTPROB.xxx,  where "xxx"  is  the first three letters of your  last
  906.     name.    Use  a  /  as  the  first  character  when  prompted  for  a
  907.     description.   Or,  if you prefer,  send hardcopy by  mail.    Attach
  908.     additional sheets if necessary.
  909.  
  910.     Mailing address:                          PCBoard system:
  911.  
  912.     Intermountain Softworks                   509/529-7229
  913.     P. O. Box 2043                            Hours on title page
  914.     Walla Walla, WA 99362                     24-hour validation required
  915.                                                 for uploads
  916.  
  917.     Name:___________________________________  Registered user ($10 paid)?
  918.     Company:________________________________    Yes []  No []
  919.     Address:________________________________
  920.     City,St,Zip:____________________________  [] Software problem
  921.     Business or Data Phone:_________________  [] Documentation problem
  922.     Home Phone:_____________________________  [] Other
  923.  
  924.     What is the three-digit VERSION number displayed in CONDOR's
  925.     copyright box? ______
  926.  
  927.     Computer make______________________model________cpu_________
  928.  
  929.     Version of PCBoard in use:________ Doorware version_________
  930.  
  931.     Are you running doorware under MONITOR 15.1A?  [] Yes  [] No
  932.  
  933.     Running PCBoard under a true network or DoubleDOS?  [] Yes  [] No
  934.     If so, please detail your network or multi-tasking hardware:
  935.  
  936.  
  937.  
  938.  
  939.     If so, please detail all software used for the network:
  940.  
  941.  
  942.  
  943.  
  944.     What SPECIFIC error messages are you getting from CONDOR?
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.                                    Page 16                                    
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.     CONDOR.EXE - Installation and Use
  959.  
  960.     
  961.     Appendix B - CONDOR Problem Report Form (continued)
  962.  
  963.     If  a  doorware application is resident,  which one,  and what  error
  964.     messages are you getting, if any?
  965.  
  966.  
  967.     Please supply exact contents of batch file that invokes CONDOR:
  968.  
  969.  
  970.  
  971.     Please  CLEARLY  detail  the problem  (attach  additional  sheets  if
  972.     necessary):
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.     Please include suggestions for improvement,  either in the program or
  987.     the   documentation.    All  suggestions  become  the   property   of
  988.     Intermountain Softworks.
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.                                    Page 17                                    
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.     CONDOR.EXE - Installation and Use
  1019.  
  1020.     
  1021.     Appendix C - CONDOR Registration Request Form
  1022.  
  1023.     SEND TO:
  1024.  
  1025.     Intermountain Softworks
  1026.     P. O. Box 2043
  1027.     Walla Walla, WA  99362
  1028.  
  1029.     Quan Item    Price  Total         [2.01]
  1030.  
  1031.     [ ]  Diskettes $10:_____________________
  1032.     [ ]  Support   $10:_____________________
  1033.     Company P.O.  +$ 5:_____________________
  1034.     WA orders add 7.9%:_____________________
  1035.     TOTAL (US dollars):_____________________
  1036.  
  1037.     [] Check [] Money Order [] Company P.O.
  1038.  
  1039.     SHIP ORDER / USER MAIL / BBS VALIDATION
  1040.  
  1041.     Name:___________________________________
  1042.     Company:________________________________
  1043.     Address:________________________________
  1044.     City,St,Zip:____________________________
  1045.     Business or Data Phone:_________________
  1046.     Home Phone:_____________________________
  1047.  
  1048.     Choice of BBS password:_________________
  1049.      (Limit of 12 characters, one word please!)
  1050.  
  1051.     Registered  users  automatically receive complementary validation  on
  1052.     our  PCBoard system,  which operates 24  hours weekends,  and between
  1053.     1600h and 0600h Monday through Friday.   On weekdays,  the system  is
  1054.     subject to availability after midnight (Pacific).
  1055.  
  1056.     509/529-7229
  1057.  
  1058.     No parity, 8 data bits, 1 stop bit
  1059.     Bit rates: 2400, 1200
  1060.  
  1061.     Thank you!
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.                                    Page 18                                    
  1072.